<?php

namespace App\Http\Controllers;

use App\Models\Tag;
use Illuminate\Http\Request;
use Illuminate\Http\JsonResponse;
use Illuminate\Validation\Rule;
use Illuminate\Database\QueryException;

class TagController extends Controller
{
    /**
     * 标签列表，支持分页和搜索，并附带文章计数
     *
     * @param Request $request
     * @return JsonResponse
     */
    public function index(Request $request): JsonResponse
    {
        // 验证请求参数
        $validated = $request->validate([
            'per_page' => 'integer|min:1|max:100',
            'page' => 'integer|min:1',
            'search' => 'nullable|string|max:255'
        ], [
            'per_page.integer' => '每页数量必须为整数',
            'per_page.min' => '每页数量至少为1',
            'per_page.max' => '每页数量最多为100',
            'page.integer' => '页码必须为整数',
            'page.min' => '页码至少为1',
            'search.max' => '搜索关键词不能超过255个字符',
        ]);

        $perPage = $validated['per_page'] ?? 10;
        $page = $validated['page'] ?? 1;
        $search = $validated['search'] ?? null;

        // 构建查询，并使用 withCount 统计文章数量
        $query = Tag::withCount('articles')->orderBy('created_at', 'desc');

        // 搜索过滤
        if ($search) {
            $query->where(function($q) use ($search) {
                $q->where('name', 'like', "%{$search}%")
                ->orWhere('slug', 'like', "%{$search}%");
            });
        }

        // 执行分页查询，并让 paginate() 自动生成标准的 JSON 结构
        // 包含 articles_count 字段
        $tags = $query->paginate($perPage, ['id', 'name', 'slug', 'articles_count'], 'page', $page);

        return response()->json($tags, 200);
    }

    /**
     * 前台展示：获取最新10条标签数据
     *
     * @return JsonResponse
     */
    public function latest(): JsonResponse
    {
        // 简单查询最新10条标签，与 CategoryController 的 latest 方法一致
        $tags = Tag::select('id', 'name', 'slug')
            ->orderBy('created_at', 'desc')
            ->take(10)
            ->get();

        return response()->json([
            'data' => $tags,
            'message' => '成功获取最新标签'
        ], 200);
    }

    /**
     * 创建新标签
     *
     * @param Request $request
     * @return JsonResponse
     */
    public function store(Request $request): JsonResponse
    {
        // 验证请求数据，只验证 name 字段，slug 由 Trait 自动生成
        $validated = $request->validate([
            'name' => 'required|string|max:50|unique:tags,name',
        ], [
            'name.required' => '标签名称不能为空',
            'name.max' => '标签名称不能超过50个字符',
            'name.unique' => '标签名称已存在',
        ]);

        // 创建标签，HasUniqueSlug Trait 会在 creating 事件中自动生成 slug
        $tag = Tag::create($validated);

        return response()->json([
            'data' => $tag,
            'message' => '标签创建成功',
        ], 201);
    }

    /**
     * 更新标签
     *
     * @param Request $request
     * @param Tag $tag
     * @return JsonResponse
     */
    public function update(Request $request, Tag $tag): JsonResponse
    {
        // 验证请求数据，只验证 name 字段，并忽略当前标签
        $validated = $request->validate([
            'name' => [
                'required',
                'string',
                'max:50',
                Rule::unique('tags', 'name')->ignore($tag->id),
            ],
        ], [
            'name.required' => '标签名称不能为空',
            'name.max' => '标签名称不能超过50个字符',
            'name.unique' => '标签名称已存在',
        ]);

        // 更新标签，HasUniqueSlug Trait 会在 updating 事件中自动更新 slug
        $tag->update($validated);

        return response()->json([
            'data' => $tag,
            'message' => '标签更新成功',
        ], 200);
    }

    /**
     * 删除标签
     *
     * @param Tag $tag
     * @return JsonResponse
     */
    public function destroy(Tag $tag): JsonResponse
    {
        try {
            // 删除标签，会自动处理关联关系
            $tag->delete();
            // 返回 204 No Content，表示成功但无返回体
            return response()->json(null, 204);
        } catch (QueryException $e) {
            // 检查是否是外键约束异常（例如该标签下存在文章）
            if ($e->getCode() === '23000') {
                return response()->json([
                    'message' => '该标签下存在文章，无法删除。'
                ], 409); // 409 Conflict
            }

            // 处理其他异常
            return response()->json([
                'message' => '删除标签失败',
            ], 500);
        }
    }
}
